This software is a [WebExtension](https://wiki.mozilla.org/WebExtensions) to save web pages to the [Wayback Machine](https://archive.org/web/).

# Use

This WebExtension offers three ways to save the current page to Archive.org

1. Use the keyboard shortcut **Ctrl+Period**

2. Click on the toolbar icon
   
   ![Save to Archive.org](https://notabug.org/zPlus/archive-webextension/raw/master/docs/toolbar_icon.png)

3. Select the item on the context menu
    
   ![Save to Archive.org](https://notabug.org/zPlus/archive-webextension/raw/master/docs/context_menu.png)

# Installation

Visit [addons.mozilla.org](https://addons.mozilla.org/en-US/firefox/addon/archive-webextension/)

# Development

- [WebExtensions documentation](https://developer.mozilla.org/en-US/Add-ons/WebExtensions)
- Install [web-ext](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Getting_started_with_web-ext)
- List of Firefox's [keyboard shortcuts](https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly)

## Run/Debug

- `$ cd extension/path/`
- `$ web-ext run --firefox-binary=...`

## Build package (XPI)

- `$ cd extension/path/`
- `$ web-ext build`

## Sign

[Signing the source code is required by Mozilla](https://developer.mozilla.org/en-US/Add-ons/Distribution), otherwise the extension will not be installed.

Mozilla will sign the app themselves before publishing it to addons.mozilla.org.

If you want to sign your own version of this extension, follow these steps:

1. Build your XPI locally (see above)
2. Create an account at [addons.mozilla.org](http://addons.mozilla.org)
3. Follow the website to upload your XPI
4. You should now be able to download the signed XPI from the website

# License

Licensed under the GNU General Public License, either version 3 or (at your option) any later version.